《Android 开源库》 Matisse，来自知乎的PhotoPicker

简介

Matisse，是一款由知乎开源的媒体选择器。

在Activity和Fragment中使用
支持JPEG，PNG，GIF的图片选择和MPEG，MP4格式的视频选择。不能同时选择图片和视频
两种主题可供选择，因为知乎也是两种主题
图片Loader
自定义过滤条件

使用方法

Gradle

repositories {
    jcenter()
}

dependencies {
    compile 'com.zhihu.android:matisse:0.4.3'
}

ProGuard

如果使用Glide作为图片加载开源库

-keep public class * implements com.bumptech.glide.module.GlideModule
-keep public enum com.bumptech.glide.load.resource.bitmap.ImageHeaderParser$** {
  **[] $VALUES;
  public *;
}

# for DexGuard only
-keepresourcexmlelements manifest/application/meta-data@value=GlideModule

如果使用Picasso作为图片加载开源库

1	-dontwarn com.squareup.okhttp.**

代码使用

知乎主题

Matisse.from(MainActivity.this)
        .choose(MimeType.ofAll())
        .countable(true)
        .maxSelectable(9)
        .addFilter(new GifSizeFilter(320, 320, 5 * Filter.K * Filter.K))
        .gridExpectedSize(
                getResources().getDimensionPixelSize(R.dimen.grid_expected_size))
        .restrictOrientation(ActivityInfo.SCREEN_ORIENTATION_PORTRAIT)
        .thumbnailScale(0.85f)
        .imageEngine(new GlideEngine())
        .forResult(REQUEST_CODE_CHOOSE);

Dracula主题

Matisse.from(MainActivity.this)
        .choose(MimeType.of(MimeType.JPEG, MimeType.PNG))
        .theme(R.style.Matisse_Dracula)
        .countable(false)
        .maxSelectable(9)
        .imageEngine(new PicassoEngine())
        .forResult(REQUEST_CODE_CHOOSE);

结果处理

List<Uri> mSelected;

@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
    super.onActivityResult(requestCode, resultCode, data);
    if (requestCode == REQUEST_CODE_CHOOSE && resultCode == RESULT_OK) {
        mSelected = Matisse.obtainResult(data);
        Log.d("Matisse", "mSelected: " + mSelected);
    }
}

更多详细内容请查阅官方Wiki.

效果

图片来源项目Github

Zhihu Style	Dracula Style	Preview

源码分析

代码结构

这里写图片描述

类分析

类名	描述
ImageEngine	图片加载接口，方便后面根据Glide和Picasso分别实现
GlideEngine	Glide实现ImageEngine
PicassoEngine	Picasso实现ImageEngine
Filter	过滤条件抽象类，我们可以通过集成Filter实现对应的过滤条件来对图片进行筛选，可以添加多个Filter,具体参考官方Demo中的GifSizeFilter
Album	相册Entity
CaptureStrategy	拍照相关，媒体处理authority
IncapableCause	信息处理，toast和dialog
Item	选择媒体界面的Item
SelectionSpec	选择参数类
AlbumLoader	相册CursorLoader
AlbumMediaLoader	图片和视频CursorLoader
AlbumCollection	AlbumLoader回调
AlbumMediaCollection	AlbumMediaLoader回调
SelectedItemCollection	被选中项集合
internal/ui包	界面显示的Adapter,自定义视图，Fragment和Activity
internal/utils包	工具类
MatisseActivity	关键类，执行选择媒体操作的时候展示出来的Activity
Matisse	开源库的入口和出口，用来传递Activity和Fragment，创建SelectionSpecBuilder和返回结果
MimeType	媒体类型
SelectionSpecBuilder	Build构造类，用来传递参数

设计思路

与PhotoPicker比较

从MatisseActivity来看的话，大致的设计思路和PhotoPicker相似，都是以单独的Activity为载体，传递参数的方式和PhotoPicker不同，PhotoPicker使用的是bundle, 而Matisse使用的是SelectionSpec单例，启动应用之前，参数全部设置完毕，然后在MatisseActivity通过SelectionSpec.getInstance()拿到单例，获取参数。选择结果和PhotoPicke实现比较相似，都是通过Bundle保存结果通过setResult返回给调用的Activity或者Fragment.
SelectedPreviewActivity就是PhotoPicker中的预览Activity，只是没有通过SelectionSpecBuilder对外暴露，要使用的话，我们只能自己显式的调用。
与PhotoPicker一样，都是采用Android Loader机制作为数据加载的方式，大致原理清楚，自己在平时的开发中还没有用到过，找个机会尝试一下。
Build设计模式，链式代码编写方式。
PhotoPicker使用的是Glide作为图片加载框架，而Matisse支持Glide和Picasso，但是Picasso支持的功能Glide全都有，选择一个即可（Picasso不支持Gif）
Matisse，支持视频文件的选择，PhotoPicker从名字上看就不支持。
PhotoPicker支持自定义样式，主要是颜色；Matisse，支持两种主题模式，与知乎呼应。